home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / t_sys5 / unixkit.tgz / unixkit.tar / unixkit / README < prev    next >
Text File  |  1992-01-13  |  16KB  |  610 lines
  1.  
  2. NOS on SunOS
  3.  
  4. Mike Westerhof, KA9WSB
  5.  
  6. November, 1991
  7.  
  8.  
  9.  
  10.  
  11. This kit is intended to help folks port NOS to UNIX systems.  It is primarily
  12. intended for Sun users, but I suspect many of the techniques are also
  13. applicable to other UNIX systems.
  14.  
  15.  
  16.  
  17.  
  18. The contents of this kit are broken into several directories:
  19.  
  20. common:        The modified source files needed for any UNIX version
  21.  
  22. lwp:        The Sun LWP library specific files
  23.  
  24. thread:        The longjmp/setjmp alternative to the LWP stuff (works
  25.         better, for the most part)
  26.  
  27. old_OS:        Some fake/hacked system include files for SunOS releases
  28.         4.0.2 and 4.0.3.  This stuff is not required for SunOS 4.1
  29.  
  30. tundrvr:    A copy of Julian Onion's tunnel driver for your UNIX OS
  31.  
  32. test:        An incomplete directory structure for testing NOS
  33.  
  34.  
  35.  
  36.  
  37. The porting procedure is relatively simple, if somewhat tedious:
  38.  
  39. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  40.  
  41. a) Obtain a copy of NOS to port.  This document describes the PA0GRI v1.7j
  42.    version, but most NOS versions based on the same KA9Q core should port
  43.    with minor changes.
  44.  
  45. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  46.  
  47. b) Convert the NOS ".ZIP" file to a standard UNIX format.  The easiest way
  48.    is to unzip the source on a PC or on a PC emulator.  You can ftp the
  49.    the source to the UNIX machine, or you can use the "dos2unix" command
  50.    on SunOS to convert the DOS text format to UNIX format.
  51.  
  52. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  53.  
  54. c) Copy the contents of the "common" directory into your NOS source
  55.    directory.  You will probably want to keep the original versions
  56.    of the modified routines.
  57.  
  58. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  59.  
  60. d) Rename the NOS "makefile" to "makefile.old" or something.
  61.  
  62. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  63.  
  64. e) Copy the contents of the "thread" directory into your NOS source
  65.    directory.  Again, you will want to keep the original versions around
  66.    somewhere.
  67.  
  68. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  69.  
  70. f) The 8250.h file is no longer necessary.  The easiest way to fix it
  71.    is to add a "#ifndef UNIX" at the top, and a "#endif" at the bottom,
  72.    like so:
  73.  
  74. *** grinos.orig/8250.h    Wed Nov 20 16:05:32 1991
  75. --- g/8250.h    Tue Nov 26 10:29:44 1991
  76. ***************
  77. *** 1,5 ****
  78. --- 1,6 ----
  79.   /* Various I/O definitions specific to asynch I/O on the IBM PC */
  80.   /* Mods by G1EMM */
  81. + #ifndef UNIX
  82.   #ifndef    _8250_H
  83.   #define    _8250_H
  84.   
  85. ***************
  86. *** 164,166 ****
  87. --- 165,168 ----
  88.   INTERRUPT asy4vec __ARGS((void));
  89.   
  90.   #endif    /* _8250_H */
  91. + #endif  /* not UNIX */
  92.  
  93. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  94.  
  95. g) The hardware.h file will give you a little grief; get rid of the
  96.    "clrbit" and "setbit" definitions.
  97.  
  98. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  99.  
  100. h) There is a little nasty bit of code in kernel.c that needs to
  101.    be fixed to use the normal "free" technique.  See the comments
  102.    in "bsdunix.c" for details, but start with this change:
  103.  
  104. *** grinos.orig/kernel.c    Fri Nov 22 10:05:50 1991
  105. --- g/kernel.c    Tue Nov 26 10:35:15 1991
  106. ***************
  107. *** 167,174 ****
  108.       /* Free allocated memory resources */
  109.       if(pp->freeargs){
  110.           argv = pp->parg1;
  111. !         while(pp->iarg-- != 0)
  112. !             free(*argv++);
  113.           free(pp->parg1);
  114.       }
  115.       free(pp->name);
  116. --- 167,176 ----
  117.       /* Free allocated memory resources */
  118.       if(pp->freeargs){
  119.           argv = pp->parg1;
  120. !         while(pp->iarg-- != 0){
  121. !             free(*argv);
  122. !             argv++;
  123. !         }
  124.           free(pp->parg1);
  125.       }
  126.       free(pp->name);
  127.  
  128.  
  129. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  130.  
  131. i) There is some yucky bit of PC-specific code in NOS that is not
  132.    ifdef'd properly.
  133.  
  134. *** grinos.orig/mbuf.c    Wed Nov 20 16:06:28 1991
  135. --- g/mbuf.c    Tue Nov 26 10:35:25 1991
  136. ***************
  137. *** 37,42 ****
  138. --- 37,43 ----
  139.       while(Intqlen < Nibufs){
  140.           if((bp = alloc_mbuf(Ibufsize)) == NULLBUF)
  141.               break;
  142. + #ifndef UNIX
  143.   #ifndef    notdef        /* Temp hack to satisfy PI DMA requirements */
  144.           dma_abs = ((long)FP_SEG(bp->data) << 4) + (long)FP_OFF(bp->data);
  145.           dma_page = dma_abs >> 16;
  146. ***************
  147. *** 47,52 ****
  148. --- 48,54 ----
  149.               restore(i_state);
  150.               continue;
  151.           }
  152. + #endif
  153.   #endif
  154.   
  155.           i_state = dirps();
  156.  
  157. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  158.  
  159. j) And there are plenty of little compiler disagreements; some places in
  160.    NOS where the definition of a function is "extern static int foo()", but
  161.    the actual routine is declared as "int foo()"...  Some things the
  162.    compiler just doesn't like.
  163.  
  164.  
  165. *** grinos.orig/axheard.c    Wed Nov 20 16:05:45 1991
  166. --- g/axheard.c    Tue Nov 26 10:30:11 1991
  167. ***************
  168. *** 11,17 ****
  169.   #include "ip.h"
  170.   #include "timer.h"
  171.   
  172. ! #define iscallsign(c) ((isupper(c)) || (isdigit(c)) || (c =='\x20'))
  173.   int axheard_filter_flag = AXHEARD_PASS;
  174.   
  175.   static struct lq *al_create __ARGS((struct iface *ifp,char *addr));
  176. --- 11,17 ----
  177.   #include "ip.h"
  178.   #include "timer.h"
  179.   
  180. ! #define iscallsign(c) ((isupper(c)) || (isdigit(c)) || (c ==' '))
  181.   int axheard_filter_flag = AXHEARD_PASS;
  182.   
  183.   static struct lq *al_create __ARGS((struct iface *ifp,char *addr));
  184.  
  185.  
  186. *** grinos.orig/bootpcmd.c    Wed Nov 20 16:05:48 1991
  187. --- g/bootpcmd.c    Tue Nov 26 10:30:38 1991
  188. ***************
  189. *** 12,19 ****
  190.   
  191.   
  192.   #include <stdio.h>
  193. ! #include <sys\types.h>
  194. ! #include <sys\stat.h>
  195.   #include <time.h>
  196.   #include <ctype.h>
  197.   #ifdef    ANSIPROTO
  198. --- 12,19 ----
  199.   
  200.   
  201.   #include <stdio.h>
  202. ! #include <sys/types.h>
  203. ! #include <sys/stat.h>
  204.   #include <time.h>
  205.   #include <ctype.h>
  206.   #ifdef    ANSIPROTO
  207.  
  208.  
  209. *** grinos.orig/bootpd.c    Wed Nov 20 16:05:48 1991
  210. --- g/bootpd.c    Tue Nov 26 10:30:55 1991
  211. ***************
  212. *** 18,25 ****
  213.   
  214.   
  215.   #include <stdio.h>
  216. ! #include <sys\types.h>
  217. ! #include <sys\stat.h>
  218.   #include <ctype.h>
  219.   #include <time.h>
  220.   
  221. --- 18,25 ----
  222.   
  223.   
  224.   #include <stdio.h>
  225. ! #include <sys/types.h>
  226. ! #include <sys/stat.h>
  227.   #include <ctype.h>
  228.   #include <time.h>
  229.   
  230. ***************
  231. *** 379,389 ****
  232.   struct iface *iface;
  233.   struct host *hp;
  234.   {
  235. !     char     cookie[5] = {99, 130, 83, 99, 0};
  236.       int     len;
  237.       int    mod;
  238.       int    i;
  239.       char    *sizep;
  240.   
  241.       /* Magic cookie */
  242.       strcpy (vend, cookie); 
  243. --- 379,395 ----
  244.   struct iface *iface;
  245.   struct host *hp;
  246.   {
  247. !     char     cookie[5];
  248.       int     len;
  249.       int    mod;
  250.       int    i;
  251.       char    *sizep;
  252. + 
  253. +     cookie[0] = 99;
  254. +     cookie[1] = 130;
  255. +     cookie[2] = 83;
  256. +     cookie[3] = 99;
  257. +     cookie[4] = 0;
  258.   
  259.       /* Magic cookie */
  260.       strcpy (vend, cookie); 
  261.  
  262.  
  263. *** grinos.orig/bootpdip.c    Wed Nov 20 16:05:49 1991
  264. --- g/bootpdip.c    Tue Nov 26 10:31:07 1991
  265. ***************
  266. *** 904,910 ****
  267.    *      q_enqueue()
  268.    *              Enqueue an element in a simple Q.
  269.    */
  270. ! void
  271.   q_enqueue(queue, elem)
  272.   struct q *queue;
  273.   struct q_elt *elem;
  274. --- 904,910 ----
  275.    *      q_enqueue()
  276.    *              Enqueue an element in a simple Q.
  277.    */
  278. ! static void
  279.   q_enqueue(queue, elem)
  280.   struct q *queue;
  281.   struct q_elt *elem;
  282.  
  283.  
  284. *** grinos.orig/domain.c    Wed Nov 20 16:05:55 1991
  285. --- g/domain.c    Tue Nov 26 10:31:48 1991
  286. ***************
  287. *** 158,164 ****
  288.       return subcmd(Dcmds,argc,argv,p);
  289.   }
  290.   
  291. ! int
  292.   docache(argc,argv,p)
  293.   int argc;
  294.   char *argv[];
  295. --- 158,164 ----
  296.       return subcmd(Dcmds,argc,argv,p);
  297.   }
  298.   
  299. ! static int
  300.   docache(argc,argv,p)
  301.   int argc;
  302.   char *argv[];
  303.  
  304.  
  305. *** grinos.orig/nrcmd.c    Wed Nov 20 16:06:37 1991
  306. --- g/nrcmd.c    Tue Nov 26 10:35:40 1991
  307. ***************
  308. *** 1063,1069 ****
  309.   
  310.       return 0 ;
  311.   }
  312. ! int
  313.   donrload(argc,argv,p)
  314.   int argc ;
  315.   char *argv[] ;
  316. --- 1063,1069 ----
  317.   
  318.       return 0 ;
  319.   }
  320. ! static int
  321.   donrload(argc,argv,p)
  322.   int argc ;
  323.   char *argv[] ;
  324. ***************
  325. *** 1135,1141 ****
  326.       return 0;
  327.   }
  328.   
  329. ! int
  330.   donrsave(argc,argv,p)
  331.   int argc ;
  332.   char *argv[] ;
  333. --- 1135,1141 ----
  334.       return 0;
  335.   }
  336.   
  337. ! static int
  338.   donrsave(argc,argv,p)
  339.   int argc ;
  340.   char *argv[] ;
  341.  
  342.  
  343. *** grinos.orig/popcli.c    Wed Nov 20 16:06:46 1991
  344. --- g/popcli.c    Tue Nov 26 10:35:47 1991
  345. ***************
  346. *** 278,285 ****
  347.       char *cp;
  348.       struct sockaddr_in fsocket;
  349.       struct pop_ccb    *ccb;
  350. !     void pop_csm(struct pop_ccb *);
  351. !     void quit_session(struct pop_ccb *);
  352.   
  353.       ccb = (struct pop_ccb *)cb1;
  354.       fsocket.sin_family = AF_INET;
  355. --- 278,285 ----
  356.       char *cp;
  357.       struct sockaddr_in fsocket;
  358.       struct pop_ccb    *ccb;
  359. !     void pop_csm __ARGS((struct pop_ccb *));
  360. !     void quit_session __ARGS((struct pop_ccb *));
  361.   
  362.       ccb = (struct pop_ccb *)cb1;
  363.       fsocket.sin_family = AF_INET;
  364. ***************
  365. *** 347,354 ****
  366.   {
  367.       FILE *mf;
  368.   
  369. !     int mlock (char *,char *);
  370. !     int rmlock (char * ,char *);
  371.       void quit_session __ARGS((struct pop_ccb *));
  372.       /* int mlock __ARGS((char *dir,char *id));   */
  373.       /* int rmlock __ARGS((char *dir,char *id));   */
  374. --- 347,354 ----
  375.   {
  376.       FILE *mf;
  377.   
  378. !     int mlock __ARGS((char *,char *));
  379. !     int rmlock __ARGS((char * ,char *));
  380.       void quit_session __ARGS((struct pop_ccb *));
  381.       /* int mlock __ARGS((char *dir,char *id));   */
  382.       /* int rmlock __ARGS((char *dir,char *id));   */
  383.  
  384.  
  385. *** grinos.orig/popserv.c    Wed Nov 20 16:06:46 1991
  386. --- g/popserv.c    Tue Nov 26 10:35:52 1991
  387. ***************
  388. *** 212,228 ****
  389.   struct pop_scb *scb;
  390.   {
  391.       char password[40];
  392. !     void state_error(struct pop_scb *,char *);
  393. !     void open_folder(struct pop_scb *);
  394. !     void do_cleanup(struct pop_scb *);
  395. !     void read_message(struct pop_scb *);
  396. !     void retrieve_message(struct pop_scb *);
  397. !     void deletemsg(struct pop_scb *,int);
  398. !     void get_message(struct pop_scb *,int);
  399. !     void print_message_length(struct pop_scb *);
  400. !     void close_folder(struct pop_scb *);
  401.   #ifdef POP_FOLDERS
  402. !     void select_folder(struct pop_scb *);
  403.   #endif
  404.   
  405.       if(scb == NULLSCB)
  406. --- 212,228 ----
  407.   struct pop_scb *scb;
  408.   {
  409.       char password[40];
  410. !     void state_error __ARGS((struct pop_scb *,char *));
  411. !     void open_folder __ARGS((struct pop_scb *));
  412. !     void do_cleanup __ARGS((struct pop_scb *));
  413. !     void read_message __ARGS((struct pop_scb *));
  414. !     void retrieve_message __ARGS((struct pop_scb *));
  415. !     void deletemsg __ARGS((struct pop_scb *,int));
  416. !     void get_message __ARGS((struct pop_scb *,int));
  417. !     void print_message_length __ARGS((struct pop_scb *));
  418. !     void close_folder __ARGS((struct pop_scb *));
  419.   #ifdef POP_FOLDERS
  420. !     void select_folder __ARGS((struct pop_scb *));
  421.   #endif
  422.   
  423.       if(scb == NULLSCB)
  424. ***************
  425. *** 369,376 ****
  426.       int deleted = FALSE;
  427.       int msg_no = 0;
  428.       struct stat folder_stat;
  429. !     int newmail(struct pop_scb *);
  430. !     int isdeleted(struct pop_scb *,int);
  431.   
  432.       if (scb->wf == NULL)
  433.           return;
  434. --- 369,376 ----
  435.       int deleted = FALSE;
  436.       int msg_no = 0;
  437.       struct stat folder_stat;
  438. !     int newmail __ARGS((struct pop_scb *));
  439. !     int isdeleted __ARGS((struct pop_scb *,int));
  440.   
  441.  
  442.  
  443.       if (scb->wf == NULL)
  444.           return;
  445. ***************
  446. *** 534,540 ****
  447.   {
  448.       char line[BUF_LEN];
  449.       long cnt;
  450. !     void rrip(char *);
  451.   
  452.       if(scb == NULLSCB)
  453.           return;
  454. --- 534,540 ----
  455.   {
  456.       char line[BUF_LEN];
  457.       long cnt;
  458. !     void rrip __ARGS((char *));
  459.   
  460.       if(scb == NULLSCB)
  461.           return;
  462. ***************
  463. *** 562,568 ****
  464.   {
  465.       char line[BUF_LEN];
  466.       long ftell();
  467. !     void rrip(char *);
  468.   
  469.       if(scb == NULLSCB)
  470.           return;
  471. --- 562,568 ----
  472.   {
  473.       char line[BUF_LEN];
  474.       long ftell();
  475. !     void rrip __ARGS((char *));
  476.   
  477.       if(scb == NULLSCB)
  478.           return;
  479.  
  480.  
  481.  
  482. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  483.  
  484. j) And... some outright bugs.  Here's one that you might fix if your
  485.    version of NOS doesn't have it fixed.
  486.  
  487. *** grinos.orig/rspf.c    Wed Nov 20 16:06:57 1991
  488. --- g/rspf.c    Tue Nov 26 10:36:01 1991
  489. ***************
  490. *** 392,398 ****
  491.           goodbadnews(adj);            /* ..that is good news */
  492.       break;
  493.       }
  494. !     stop_timer(&oldadj->timer);        /* stop timer before free() -- KZ1F */
  495.       free((char *)oldadj);
  496.   }
  497.   
  498. --- 392,399 ----
  499.           goodbadnews(adj);            /* ..that is good news */
  500.       break;
  501.       }
  502. !     if(oldadj != NULLADJ)            /* Careful! KA9WSB */
  503. !         stop_timer(&oldadj->timer);        /* stop timer before free() -- KZ1F */
  504.       free((char *)oldadj);
  505.   }
  506.   
  507.  
  508. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  509.  
  510. k) Don't forget to update the version.c file so that you know what version
  511.    you happen to be running :-)
  512.  
  513. *** grinos.orig/version.c    Wed Nov 20 16:07:20 1991
  514. --- g/version.c    Tue Nov 26 10:37:52 1991
  515. ***************
  516. *** 2,10 ****
  517.   #include "config.h"
  518.   #include "global.h"
  519.   #include "mbuf.h"
  520. ! char Version[] = "910618 (PA0GRI v1.7j)";
  521. ! char Version2[] = "This version produced by Gerard van der Grinten - PA0GRI";
  522. ! 
  523.   int
  524.   doinfo(argc,argv,p)
  525.   int argc;
  526. --- 2,9 ----
  527.   #include "config.h"
  528.   #include "global.h"
  529.   #include "mbuf.h"
  530. ! char Version[] = "910618 (PA0GRI v1.7j) (KA9WSB Tb)";
  531. ! char Version2[] = "This version produced by Gerard van der Grinten - PA0GRI\nPorted to SunOS by KA9WSB";
  532.   int
  533.   doinfo(argc,argv,p)
  534.   int argc;
  535.  
  536. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  537.  
  538. l) If you have an older compiler, you might get complaints about a duplicate
  539.    routine.  There is a declaration for "domotd" in the mailbox.c file that
  540.    may upset the compiler.  The simplest fix is to change all references
  541.    to "domotd" to "dombmotd" in the mailbox.c file.
  542.  
  543. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  544.  
  545. m) Update the config.h file to reflect your environment.  Note! PPP is
  546.    is so Turbo-C/DOS specific that I haven't been able to get it compiled
  547.    at all.  The Makefile doesn't reference any PPP sources, so don't define
  548.    PPP in config.h.  Following is the file I use:
  549.  
  550. /* Software options */
  551. #define    MAILBOX        1    /* Include SM0RGV mailbox server */
  552. #define    NNTP        1    /* Netnews client */
  553. #define    SERVERS        1    /* Include TCP servers */
  554. #define    TRACE        1    /* Include packet tracing code */
  555. #define    RIP        1    /* Include RIP routing */
  556. #define    HOPCHECK    1    /* IP path tracing command */
  557. #define    DIALER        1    /* SLIP redial code */
  558. #define    NRS        1    /* NET/ROM async interface */
  559. #define    NETROM        1    /* NET/ROM network support */
  560. #undef    LZW        1    /* LZW-compressed sockets */
  561. #define RLOGINCLI    1    /* Rlogin client code */
  562. #define    SLIP        1    /* Serial line IP on built-in ports */
  563. #undef    PPP        1    /* Point-to-Point Protocol code */
  564. #undef    VJCOMPRESS    1    /* Van Jacobson TCP compression for SLIP */
  565. #define    POP        1    /* Include POP2 Post Office Protocol */
  566. #define ESCAPE        1    /* Allow Unix style escape on PC */
  567. #define    RSPF        1    /* Include Radio Shortest Path First Protocol */
  568. #define AXIP        1    /* digipeater via ip port 93 interface */
  569.  
  570. /* Software tuning parameters */
  571. #define    MTHRESH        8192    /* Default memory threshold */
  572. #define    NROWS        25    /* Number of rows on screen */
  573. #define    NIBUFS        5    /* Number of interrupt buffers */
  574. #define    IBUFSIZE    2048    /* Size of interrupt buffers */
  575. #define    NSESSIONS    10    /* Number of interactive clients */
  576. #define DEFNSOCK    40    /* Default number of sockets */
  577.  
  578. /* Hardware driver options */
  579. #undef    ARCNET        1    /* ARCnet via PACKET driver */
  580. #undef    PC_EC        1    /* 3-Com 3C501 Ethernet controller */
  581. #define    KISS        1    /* KISS TNC code */
  582. #undef    HS        1    /* High speed (56kbps) modem driver */
  583. #undef    HAPN        1    /* Hamilton Area Packet Network driver code */
  584. #undef    EAGLE        1    /* Eagle card driver */
  585. #define    PACKET        1    /* FTP Software's Packet Driver interface */
  586. #undef    PC100        1    /* PAC-COM PC-100 driver code */
  587. #undef    APPLETALK    1    /* Appletalk interface (Macintosh) */
  588. #undef    DRSI        1    /* DRSI PCPA slow-speed driver */
  589. #undef    SCC        1    /* PE1CHL generic scc driver */
  590. #undef    PI        1    /* VE3IFB pi dma card scc driver */
  591. #define    ASY        1    /* Asynch driver code */
  592. #undef    SLFP        1    /* SLFP packet driver class supported */
  593.  
  594. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  595.  
  596. n) If you want to use the nit driver instead the tunnel driver, you'll have
  597.    to change the Makefile (and cross your fingers!).
  598.  
  599. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  600.  
  601. m) Type "make"... then fix all the problems you encounter (easier said than
  602.    done)!
  603.  
  604. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  605.  
  606. n) Once you get it compiled, you can test it.  The "test" directory contains
  607.    an incomplete sample directory structure, and a sample startup.nos file.
  608.  
  609. % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %
  610.